MCP server
Trotto offers a hosted MCP (Model Context Protocol) server so an AI agent — Claude Code, the Claude API, Claude Desktop, or your own agent stack — can search and create your organization's go links. It is the agent-native front end to the same links API described on the API access page; whatever an agent can do is governed entirely by the API key you give it.
To get started, email help@trot.to. We'll provide your MCP endpoint and an API key that matches how you want to use it, along with setup instructions for your client.
Authentication
The MCP server uses the same API keys as the REST API. Your key is sent in the Authorization header (a Bearer prefix is also accepted). What the agent can do depends on the key's scope:
- A read-only API key can use the
search_linkstool;create_linkis refused with a clear message. - A create API key can use both
search_linksandcreate_link; new links are owned by the key's user.
See the API access page for the full list of key kinds. Treat any key like a password — keep it secret, and let us know if it is ever exposed so we can revoke it.
Tools
search_links
Search your organization's go links.
| Argument | Description |
|---|---|
query | Optional. Fuzzy-match shortpaths, best matches first (for example, roadmap). |
destination | Optional. Return links whose destination URL is an exact match. |
page | Optional, default 1. Results are paginated, 20 per page. |
Pass no arguments to list all links. Each result includes the shortpath, destination URL, owner, namespace, and visit count, along with page, total, and total_pages so an agent can page through everything.
create_link
Create a new go link. Requires a create (or admin) API key.
| Argument | Description |
|---|---|
shortpath | Required. The go link path, for example roadmap. |
destination | Required. The full destination URL. |
namespace | Optional. Defaults to your organization's default namespace (usually go). |
unlisted | Optional, default false. If true, the link is hidden from other members' searches. |
Returns the created link. Attempting to create a shortpath that already exists returns a clear error.
Connecting your client
The server speaks MCP over Streamable HTTP, so any MCP-capable client works — you point it at your Trotto MCP endpoint and set the Authorization header with your key. There is nothing to install beyond your client.
Email help@trot.to and we'll send you your endpoint and step-by-step setup for your client, whether that's Claude Code, the Claude API, Claude Desktop, or another MCP-capable agent.
Limits
- Read-only and create API keys are rate limited to 50 requests per hour, shared across both tools.
- Errors come back as clear tool errors an agent can act on: a missing, invalid, or revoked key; an hourly rate limit being exceeded; or a read-only key attempting to create a link.